draw广告

简介

draw广告分为自渲染广告和模板广告，类型取决于三方SDK的支持情况。SDK 提供draw广告的数据绑定、点击事件的上报。

①自渲染广告：聚合SDK返回物料，由开发者在返回的CloooudMCanvasView类型的canvasView上进行子视图的自行渲染和展示。

②模板广告：聚合SDK直接返回渲染好的广告CloooudMCanvasView，开发者直接展示即可。

注意事项 ①需要确保在SDK初始化成功后再进行广告请求，否则可能导致广告请求加载失败。

②聚合维度广告是通过广告位ID发起广告请求的，切记不要使用混淆。

③在广告接入前需要明确各ADN对应聚合广告样式情况，以确保正确完成广告接入，避免由于广告类型不匹配导致接入报错等情况的发生。

④广告加载数量以平台配置数量为准，本地数量仅在平台配置为0时有效，目前本地配置支持的广告数量为 1 ~ 3。

⑤由于各广告平台对于包名校验规则不同，需确保在媒体平台填写的包名符合各adn平台规范，避免由于包名校验不匹配导致的无广告返回情况的产生。

⑥一定要设置rootViewController，即跳转落地页需要的viewController。

接入draw广告

// 创建广告对象
- (void)p_buildAd {
        CloooudAdSlot *adSlot = [[CloooudAdSlot alloc]init];
    adSlot.ID = self.viewModel.slotID; // 聚合维度通过广告位ID发起请求，
    self.drawAdsManager = [[CloooudNativeAdsManager alloc]initWithSlot:adSlot];

    self.drawAdsManager.delegate = self;
}
// 触发广告加载
- (void)p_loadAdData {
    [self.drawAdsManager loadAdDataWithCount:3];
}
// 收到load成功回调后展示
# pragma mark ---<CloooudMNativeAdsManagerDelegate>---
- (void)nativeAdsManagerSuccessToLoad:(CloooudNativeAdsManager *)adsManager nativeAds:(NSArray<CloooudNativeAd *> *_Nullable)nativeAdDataArray{
    /// 注意,demo仅处理了首个广告
    CloooudNativeAd *model = nativeAdDataArray.firstObject;
    model.rootViewController = self;
    model.delegate = self;
    model.mediation.videoDelegate = self;

    CGFloat screenWidth = CGRectGetWidth(self.view.frame);
    CGFloat screenHeight = CGRectGetHeight(self.view.frame);
    CGFloat height = screenHeight - (CGRectGetMaxY(self.showAndRefreshAd.frame) + 20) - 100;
    CGFloat width = screenWidth * height / CGRectGetHeight(self.view.frame);
    CGFloat x = (screenWidth - width ) / 2;

    if (model.mediation.isExpressAd) {
        model.mediation.canvasView.frame = CGRectMake(x, CGRectGetMaxY(self.showAndRefreshAd.frame) + 20, width, height);
        [self.view addSubview:model.mediation.canvasView];
        [model.mediation render];
    } else {
        [_drawAdBackView removeFromSuperview];
        _drawAdBackView = [[CloooudMDDrawVideoAdView alloc] initWithFrame:CGRectMake(x, CGRectGetMaxY(self.showAndRefreshAd.frame) + 20, width, height)];
        _drawAdBackView.backgroundColor = [UIColor grayColor];

        __weak typeof(self) weakself = self;
        self.drawAdBackView.cellClose = ^(NSInteger index) {
            __strong typeof(self) strongself = weakself;
            [strongself.drawAdBackView removeFromSuperview];
        };
        [_drawAdBackView refreshUIWithModel:model];

        _drawAdBackView.drawAdView.mediation.videoDelegate = self;
        [self.view addSubview:_drawAdBackView];
    }
}

获取展示后广告信息示例

在收到加载成功回调后访问可获取到正确信息

- (void)logAdInfoAfterShow {
    CloooudMRitInfo *info = [self.drawAdsManager.mediation getShowEcpmInfo];
    // 展示后可获取信息如下
    NSLog(@"ecpm:%@", info.ecpm); // 单位：分
    NSLog(@"platform:%@", info.adnName);
    NSLog(@"ritID:%@", info.slotID);
    NSLog(@"requestID:%@", info.requestID ?: @"None");

    NSLog(@"getAdLoadInfoList:%@", [self.drawAdsManager.mediation getAdLoadInfoList]);
}

接口及回调说明

CloooudNativeAdsManager说明

CloooudNativeAdsManagerMediationProtocol说明

CloooudNativeAdsManagerDelegate说明

CloooudNativeAd说明

CloooudNativeAd为请求原生广告返回的广告类，可直接将CloooudMCanvasView添加到父视图上进行展示，目前仅支持frame布局方式，不支持自动布局。 | 方法 | 说明 | | --- | --- | |@property (nonatomic, weak, readwrite, nullable) id delegate;|CloooudNativeAdDelegate，聚合维度使用CloooudMNativeAdDelegate| |@property (nonatomic, strong, readwrite, nullable) CloooudAdSlot adslot;|广告对象| |@property (atomic, strong, readonly, nullable) CloooudMaterialMeta data;|物料信息| |@property (nonatomic, weak, readwrite) UIViewController rootViewController;|必要，设置广告详情跳转控制器| |- (instancetype)initWithSlot:(CloooudAdSlot )slot;|创建广告对象| |- (void)registerContainer:(kindof UIView *)containerView withClickableViews:(NSArray<kindof UIView > _Nullable)clickableViews;在原生广告视图中注册可点击视图。containerView:必要；原生广告的容器视图 clickableViews:可选；可点击的视图数组| |- (void)unregisterView;|取消注册视图| |- (void)loadAdData;|加载广告| |- (NSString )getAdCreativeToken;|物料ID 聚合维度不支持| |@property (nonatomic, strong, nullable, readonly) CloooudNativeAdMediation mediation;当使用聚合广告位时，存在该属性，可获取聚合维度相关功能|

CloooudNativeAdMediationProtocol说明

CloooudMaterialMeta说明

自渲染广告物料信息

CloooudMaterialMetaMediationProtocol说明

CloooudMCanvasView说明

控件信息

CloooudNativeAdDelegate说明

CloooudMNativeAdExpressDelegate说明

CloooudMNativeAdVideoDelegate说明

完整接入示例

- (void)loadDrawAd {
    if (self.drawAdsManager) {
        // 销毁上次广告对象
        [self.drawAdsManager.mediation destory];
    }

    CloooudAdSlot *slot = [[CloooudAdSlot alloc] init];
    slot.ID = @"广告位ID"; // 聚合维度通过广告位ID发起请求，
    slot.adSize = CGSizeMake(375, 150); // 尺寸根据实际情况设置

    slot.mediation.mutedIfCan = YES; // 静音 聚合功能

    CloooudNativeAdsManager *drawAdsManager = [[CloooudNativeAdsManager alloc] initWithSlot:slot];
    drawAdsManager.mediation.rootViewController = self;
    drawAdsManager.delegate = self;
    self.drawAdsManager = drawAdsManager;

    [self.drawAdsManager loadAdDataWithCount:3]; //加载广告数量，支持1-3个
}

/******** draw信息流广告加载回调处理 *********/
# pragma mark CloooudMNativeAdsManagerDelegate
// 广告加载成功
- (void)nativeAdsManagerSuccessToLoad:(CloooudNativeAdsManager *)adsManager nativeAds:(NSArray<CloooudNativeAd *> *_Nullable)nativeAdDataArray {

    for (CloooudNativeAd *model in nativeAdDataArray) {

        model.rootViewController = self;
        model.delegate = self;
        if (model.mediation.isExpressAd) {
            [model.mediation render];
        } else {
            // 开发者需自行渲染广告，渲染到model.mediation.canvasView上
            // 可以通过model.data.imageMode判断广告样式(大图/视频/组图...)
            // 可以通过model.data.imageAry获取图片数据
            // 可以通过model.data.AdTitle获取广告标题
            // 详情请查看接入文档
            [self customRenderAd:model];
        }

        /*  (注意: getShowEcpmInfo 只需要在当前 adView show 之后调用, show 之前调用该方法会返回 nil)
        CloooudMRitInfo *info = [model.mediation getShowEcpmInfo];
        NSLog(@"ecpm:%@", info.ecpm);
        NSLog(@"platform:%@", info.adnName);
        NSLog(@"ritID:%@", info.slotID);
        NSLog(@"requestID:%@", info.requestID ?: @"None");
        */

        CloooudDictionary *mediaExt = model.mediation.extraData;
        if (mediaExt) {
            NSLog(@"coupon:%@", mediaExt[@"coupon"]);
            NSLog(@"live_room:%@", mediaExt[@"live_room"]);
            NSLog(@"product:%@", mediaExt[@"product"]);
        }

        // 展示广告
        if (model.mediation.canvasView) {
            [self.view addSubview:model.mediation.canvasView];
        }
    }
}

// 广告加载失败
- (void)nativeAdsManager:(CloooudNativeAdsManager *)adsManager didFailWithError:(NSError *_Nullable)error {

}

详细示例请参见Demo。